package com.zqh.forum.services;

import com.zqh.forum.model.Article;
import org.apache.ibatis.annotations.Param;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

public interface IArticleService {

    /**
     * 发布帖子
     * 在这个过程中我们会调用到mapper中的三条sql语句（一条添加，两条数据的更新（））
     * @param article
     */
    @Transactional //当前方法中的执行过程会被事务管理起来（所有的操作同时成功，或者同时失败）
    void create (Article article);

    /**
     * 查询所有的帖子列表
     * @return
     */
    List<Article> selectAll();

    /**
     * 根据板块id查询所有帖子列表
     * @param boardId
     * @return
     */
    List<Article> selectAllByBoardId(Long boardId);

    /**
     * 根据帖子id查询帖子详情
     * @param id
     * @return
     */
    Article selectDetailById (Long id);

    /**
     * 根据帖子id查询记录(只包含文章表中的所有字段)
     * @param id 帖子id
     * @return
     */
    Article selectById(Long id);


    /**
     * 根据帖子id更新帖子的标题和内容
     * @param id 帖子id
     * @param title 帖子标题
     * @param content 帖子内容
     */
    void modify(Long id,String title,String content);

    /**
     * 点赞帖子
     * @param id 帖子id
     */
    void thumbsUpById(Long id);

    /**
     * 根据id删除帖子
     * @param id 帖子id
     */
    @Transactional //事务管理
    void deleteById(Long id);

    /**
     * 文章回复数量+1
     * @param id 板块id
     */
    void addOneReplyCountById(Long id);

    /**
     * 根据用户id查询帖子列表
     * @param userId
     * @return
     */
    List<Article> selectByUserId(Long userId);
}
